home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / sgi2ps.z / sgi2ps
Text File  |  1998-10-30  |  17KB  |  331 lines
  1.  
  2.  
  3.  
  4. SSSSGGGGIIII2222PPPPSSSS((((1111))))                        IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                         SSSSGGGGIIII2222PPPPSSSS((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sgi2ps - convert an SGI image file to PostScript
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssggggiiii2222ppppssss [----OOOO filename] [----LLLL filename] [----BBBB]
  13.             [----CCCC colorspace] [----FFFF] [----ffff] [----rrrr angle]
  14.             [----pppp imageRes] [----zzzz factor] [----nnnn nCopies]
  15.             [----GGGG g0[,g1,g2]] [----NNNN nUpX[,nUpY]]
  16.             [----IIII filename] [----cccc filename] [----hhhh] [----DDDD]
  17.             [SGIImageFilename ...]
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _s_g_i_2_p_s converts raster files in SGI image format into PostScript code.
  21.      The program provides a number of image transformation capabilities
  22.      including zooming, rotation and gamma correction. In addition, _s_g_i_2_p_s
  23.      provides the capability to display multiple images on a single physical
  24.      page.
  25.  
  26.    CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
  27.      Typically, _s_g_i_2_p_s expects at least one SGI image file to be specified as
  28.      input on the command line after all option switches. If no image file is
  29.      specified on the command line, _s_g_i_2_p_s will read from the standard input.
  30.      By default, _s_g_i_2_p_s assumes that its output should be written to the
  31.      standard output and messages should be written to standard error.
  32.  
  33.      ----OOOO _f_i_l_e_n_a_m_e
  34.                Specifies the name of the file to which the PostScript output
  35.                will be sent.  If the ----OOOO option is not specified, output will
  36.                be sent to the standard output.
  37.  
  38.      ----LLLL _f_i_l_e_n_a_m_e
  39.                Specifies the name of the file to which error, warning and
  40.                informational messages are to be written. If the file specified
  41.                already exists, any messages generated by _s_g_i_2_p_s will be
  42.                appended to the end of the file.  If the ----LLLL option is not
  43.                specified, message output will be sent to standard error.
  44.  
  45.      ----BBBB        Specifies that binary PostScript should be output where
  46.                applicable. The majority of the output from _s_g_i_2_p_s is bitmap
  47.                image data. By default this data is output as ASCII hexadecimal
  48.                values. Specifying ----BBBB will output this image data as binary
  49.                values thereby cutting in half the number of bytes of
  50.                PostScript data output. However, binary data output should only
  51.                be used when the communications channel between _s_g_i_2_p_s and the
  52.                PostScript interpreter can accept 8-bit data. This precludes
  53.                the use of the ----BBBB switch when transmitting output over serial
  54.                connections.
  55.  
  56.      ----CCCC _c_o_l_o_r_s_p_a_c_e
  57.                Specifies the output data colorspace. The value of _c_o_l_o_r_s_p_a_c_e
  58.                may be one of the following: wwww (black and white), the default,
  59.                ccccmmmmyyyykkkk, or rrrrggggbbbb. The PostScript produced by ccccmmmmyyyykkkk and rrrrggggbbbb can only
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSGGGGIIII2222PPPPSSSS((((1111))))                        IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                         SSSSGGGGIIII2222PPPPSSSS((((1111))))
  71.  
  72.  
  73.  
  74.                be interpreted by a Level 2 PostScript interpreter or a Level 1
  75.                interpreter with the CMYK color extensions (e.g. _p_s_r_i_p(_1)). The
  76.                PostScript produced by wwww can be sent to any Level 1
  77.                interpreter. The colorspace conversion equations used by _s_g_i_2_p_s
  78.                are:
  79.  
  80.  
  81.                W to RGB: r = g = b = w
  82.  
  83.                W to CMYK: c = m = y = 0; k = 1 - w
  84.  
  85.                RGB to W: w = 0.299 r + 0.587 g + 0.114 b
  86.  
  87.                RGB to CMYK:
  88.                ci = 1 - r; mi = 1 - g; yi = 1 - b
  89.                k = min(ci, mi, yi)
  90.                c = ci - k; m = mi - k: y = yi - k
  91.  
  92.      ----FFFF        Specifies that the image should be oriented so that it best
  93.                fits the page.  That is, the image is oriented such that its
  94.                longer dimension is parallel with the longer dimension of the
  95.                paper. If ----FFFF is specified, any rotation specified by the ----rrrr
  96.                switch is ignored. By default the image is oriented with zero
  97.                degrees of rotation unless the ----rrrr switch specifies a different
  98.                rotation.
  99.  
  100.      ----ffff        Specifies that the output image should be flipped (mirrored)
  101.                about the vertical axis. This flag is useful when creating
  102.                transparencies.  Note that flipping of the image is performed
  103.                after any rotation. Therefore, the image is always flipped
  104.                about the vertical axis.
  105.  
  106.      ----rrrr _a_n_g_l_e  Specifies that the image is to be rotated by _a_n_g_l_e degrees.
  107.                _a_n_g_l_e may be any positive or negative integer value. Positive
  108.                rotations are counter-clockwise measured from the horizontal
  109.                axis. The default rotation angle is 0. Note that rotation is
  110.                performed before any image flipping (----ffff). The ----rrrr switch is
  111.                ignored if the best-fit switch ----FFFF is specified.
  112.  
  113.      ----zzzz _f_a_c_t_o_r and ----pppp _i_m_a_g_e_R_e_s
  114.                Each of these switches provides scaling of the original image.
  115.                The two switches are mutually exclusive.
  116.  
  117.                The ----zzzz switch provides image zooming.  _f_a_c_t_o_r is a positive
  118.                floating point value typically between 0.0 and 1.0. A zoom
  119.                factor of 1.0, the default, indicates that the image should be
  120.                scaled to fit the entire page while preserving the original
  121.                image's aspect ratio. A zoom factor of 0.5 would produce an
  122.                image sized to 50% of that needed to fit the entire page. A
  123.                zoom factor of 0.0 produces no zooming. Instead the image is
  124.                output at its original size.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SSSSGGGGIIII2222PPPPSSSS((((1111))))                        IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                         SSSSGGGGIIII2222PPPPSSSS((((1111))))
  137.  
  138.  
  139.  
  140.                If an image must be sized based on a given resolution, the ----pppp
  141.                switch should be specified in place of the ----zzzz switch. The
  142.                _i_m_a_g_e_R_e_s argument specifies the resolution used to size the
  143.                image in dots per inch. This resolution is independent of the
  144.                output device resolution. For example, suppose an image is one
  145.                inch by one inch when displayed on a 96 dpi monitor. In order
  146.                to print that image on a 300 dpi printer so that it remains one
  147.                inch by one inch the ----pppp switch would be specified with an
  148.                _i_m_a_g_e_R_e_s of 96.
  149.  
  150.      ----nnnn _n_C_o_p_i_e_s
  151.                Specifies the number of copies to produce of each page.
  152.                Specifying this switch simply sets the value of the ####ccccooooppppiiiieeeessss
  153.                variable in the output PostScript code. The value of this
  154.                variable is used by the PostScript operator sssshhhhoooowwwwppppaaaaggggeeee to
  155.                determine the number of output copies to produce. By default
  156.                the ####ccccooooppppiiiieeeessss variable is not specified and the number of copies
  157.                then defaults to one.
  158.  
  159.      ----GGGG _g_0[,_g_1,_g_2]
  160.                This switch provides gamma correction of the input image data.
  161.                The gamma function is:
  162.  
  163.                corrected value = value ^ gamma
  164.  
  165.                The gamma value (_g_0, etc.) is typically a value between 0.0 and
  166.                3.0. A gamma value less than 1.0 will tend to lighten the image
  167.                while a value greater than 1.0 will tend to darken the image. A
  168.                gamma of 1.0 will leave the image data unchanged.  The gamma
  169.                value may be specified for each input color channel
  170.                individually or as a group. If _g_0 is the only gamma value
  171.                specified, this value will be applied to all output channels.
  172.                Note that a black and white image contains one input color
  173.                channel, and an RGB image contains three input channels. The
  174.                default gamma value is 1.0 for all channels.
  175.  
  176.      ----NNNN _n_U_p_X[,_n_U_p_Y]
  177.                _s_g_i_2_p_s allows multiple SGI image files to be specified on the
  178.                command line. By default, each image is output on a separate
  179.                physical page.  The ----NNNN switch provides the capability to divide
  180.                up one physical page into multiple virtual pages. This is often
  181.                called n-up display. Using n-up, multiple image files can be
  182.                displayed on the same physical page. If only the _n_U_p_X value is
  183.                specified the physical page will be divided into nUpX by nUpX
  184.                virtual pages. If both _n_U_p_X and _n_U_p_Y are specified, the
  185.                physical page will be divided into _n_U_p_X by _n_U_p_Y virtual pages.
  186.                Images are displayed in row (horizontal) major order.  Note
  187.                that _n_U_p_X is measured along the horizontal, x, axis. For an 8.5
  188.                by 11.0 inch page, the horizontal axis is the short dimension
  189.                in portrait mode and the long dimension in landscape mode.
  190.                Rotation is performed on each image individually and best-fit
  191.                orientation is determined for each image individually. Zooming
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. SSSSGGGGIIII2222PPPPSSSS((((1111))))                        IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                         SSSSGGGGIIII2222PPPPSSSS((((1111))))
  203.  
  204.  
  205.  
  206.                is relative to the virtual page size. Note that image
  207.                replication is not performed. The number of images specified on
  208.                the command line is the number of images displayed in the
  209.                virtual pages.
  210.  
  211.      ----IIII _f_i_l_e_n_a_m_e
  212.                _s_g_i_2_p_s places a PostScript code prolog at the start of the
  213.                output file.  By default, this prolog code is read from the
  214.                file /_u_s_r/_l_i_b/_p_r_i_n_t/_d_a_t_a/_P_S_I_m_a_g_e_P_r_o_l_o_g.  The ----IIII switch allows a
  215.                different prolog file to be specified. This switch is not
  216.                intended for general use.
  217.  
  218.      ----cccc _f_i_l_e_n_a_m_e
  219.                The most common form of SGI Image file is the so called Normal
  220.                image. This image contains the actual intensity values for each
  221.                image channel at each pixel location.  Another form of SGI
  222.                Image file is the so called Screen image. This image consists
  223.                of a single value at each pixel. The value is an index into a
  224.                colormap that contains the actual pixel intensity values for
  225.                each channel. This type of image is also referred to as a
  226.                colormap image. In order to process a colormap image, the
  227.                colormap that corresponds to the image must be specified. By
  228.                default _s_g_i_2_p_s obtains its colormap from the file
  229.                _S_G_I_D_e_f_C_o_l_o_r_m_a_p._m_a_p. This file contains the default SGI system
  230.                colormap.  The ----cccc option can be used to specify a different
  231.                colormap file. A colormap file can be created using the
  232.                _m_a_k_e_m_a_p(_1_G) and _s_a_v_e_m_a_p(_1_G) programs. This switch is not
  233.                intended for general use.
  234.  
  235.      ----hhhh        Prints a program usage message to the standard error. This
  236.                usage message also lists the currently supported output
  237.                configurations.
  238.  
  239.      ----DDDD        Specifies verbose output for debugging purposes.
  240.  
  241. NNNNOOOOTTTTEEEESSSS
  242.      1.   The PostScript output produced by _s_g_i_2_p_s conforms to the Adobe
  243.           PostScript Document Structuring Conventions Version 3.0 as specified
  244.           in Appendix G of the "PostScript Language Reference Manual", 2nd
  245.           edition.
  246.  
  247.      2.   The _s_g_i_2_p_s program supersedes the _r_g_b_2_p_s program. The _r_g_b_2_p_s program
  248.           should not be used for new development and may be removed from
  249.           future releases.
  250.  
  251.      3.   The PostScript output produced by sgi2ps primarily wraps the input
  252.           bitmap image data with PostScript instructions. Therefore, the
  253.           amount of output data can be quit large especially if multiple image
  254.           files are specified or if the images are large. The size of the
  255.           output file should be kept in mind when sending the PostScript
  256.           output over a slow communications channel such as a serial line.
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. SSSSGGGGIIII2222PPPPSSSS((((1111))))                        IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                         SSSSGGGGIIII2222PPPPSSSS((((1111))))
  269.  
  270.  
  271.  
  272.      4.   If _s_g_i_2_p_s is given an unrecognized or incomplete command line option
  273.           switch, it will print a warning message to the standard error,
  274.           ignore the option and continue processing.
  275.  
  276.      5.   If an image file is specified on the command line, _s_g_i_2_p_s will not
  277.           read its stdin for images.
  278.  
  279.      6.   Processing an SGI Image format file requires random seeking within
  280.           the file.  Therefore, when _s_g_i_2_p_s is obtaining its input image from
  281.           a pipe to standard input, a disk based copy of the input image must
  282.           be created.  This temporary image file will be created in the
  283.           directory specified by the TTTTMMMMPPPPDDDDIIIIRRRR environment variable. If that
  284.           variable is not set, the temporary file will be created in /_v_a_r/_t_m_p.
  285.           There must be sufficient free space in the temporary file directory
  286.           to store a complete copy of the image file or _s_g_i_2_p_s will fail.
  287.  
  288.      7.   _s_g_i_2_p_s can only process a single image file when reading from
  289.           standard input.
  290.  
  291.      8.   Previous versions of _s_g_i_2_p_s performed gamma correction on the output
  292.           data. Starting with Impressario 1.2, _s_g_i_2_p_s performs gamma
  293.           correction on the input image data.
  294.  
  295.      9.   _s_g_i_2_p_s can process Normal and Screen format SGI Image files. Images
  296.           in the obsolete Dither format must be converted to Normal format
  297.           images using the _f_r_o_m_d_i(_6_D) program.
  298.  
  299. FFFFIIIILLLLEEEESSSS
  300.      /usr/lib/print/sgi2ps                     Program file
  301.      /usr/lib/print/data/PSImageProlog         PostScript prolog file
  302.      /usr/lib/print/data/SGIDefColormap.map    Default colormap file
  303.  
  304. TTTTRRRRAAAADDDDEEEEMMMMAAAARRRRKKKKSSSS
  305.      PostScript is a registered trademark of Adobe Systems, Inc.
  306.  
  307. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  308.      psrip(1), stiff2ps(1), _P_o_s_t_S_c_r_i_p_t _L_a_n_g_u_a_g_e _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l - 2nd ed.,
  309.      Adobe Systems, Inc., makemap(1G), savemap(1G), fromdi(6D)
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.